Graphisoft®

Library Developer Toolkit Version: 19

목차

  1. LP_XMLConverter 도구
  2. ArchiCAD Built-in 라이브러리
  3. 예제 라이브러리
  4. GDL 프로그래밍 표준
  5. 컴파일

LP_XMLConverter 도구

Tool 폴더 안에서 당신은 각 플랫폼들을 위한 LP_XMLConverter 도구를 찾을 수 있습니다.

이 커맨드 라인 도구는 Windows와 Macintosh 플랫폼에서 라이브러리 파트를 XML 파일로 혹은 역으로 변환합니다. 이 도구를 사용하면 개발 시기에 대한 크로스-플랫폼 텍스트-기반 포맷의 이점 덕분에 ArchiCAD 라이브러리들의 작성 프로세스를 용이하게 할 수 있습니다. 이 기능을 사용하는 것은 라이브러리 개발자들에게 가장 강력한 도구입니다.

XML 포맷은 다음을 가능하게 해줍니다:

이 도구를 사용하여 단일 파일들과 전체 라이브러리를 변환하고 컴파일할 수도 있습니다. 모든 종류의 변환에 대해 당신은 라이브러리 파트들의 문자 코드페이지를 지정할 수 있습니다.

XML 파일들을 변환하는 경우 외부 그림 파일을 사용하여 대상 라이브러리 파트에 포함시킬 수 있습니다.

컨버터는 XML에서 전체 라이브러리를 변환하여 라이브러리의 각 라이브러리 파트 파일의 조상 정보, 버전, 매크로 콜 섹션 및 파라미터 섹션을 수리하고 라이브러리에 대한 특정 검사 단계를 수행하도록 지시할 수 있습니다. 이것은 ArchiCAD에서 'Update Library Parts' 커맨드의 전체 기능을 수행하며 - 그 이상입니다.

이 도구는 다음과 같은 타입의 경고 및 오류 메시지를 작성합니다:

이 도구에 대한 더 자세한 정보는 이것의 사용자 문서를 참조하십시오.

설치

Windows

메인 zip 파일을 해제한 후에 도구를 실행할 준비가 됩니다. Perl 기반 make 스크립트를 실행하려면, ActivePerl과 ActivePython을 설치해야 합니다.

Macintosh

메인 zip 파일을 해제한 후에 zip 파일 ./Tool/OSX.zip로부터 이 도구를 제자리에 추출해야 합니다. (Tool 폴더 안에 OSX 폴더를 만듭니다) 그 후에 이 도구와 Perl 스크립트는 사용할 준비가 됩니다.

ArchiCAD Built-in 라이브러리

ArchiCAD를 이용하여 라이브러리를 생성하려면, 당신이 원하든, 원치 않든 ArchiCAD의 Built-in 라이브러리를 이용해야 합니다. 즉, 당신의 오브젝트는 ArchiCAD에서 정의된 서브타입의 후손이 될 것입니다.

라이브러리 생성 과정에서 LP_XMLConverter 도구를 이용하여 동일한 결과에 대한 이 라이브러리 파트를 가지고 있어야 합니다. 이는 Sources 폴더 안에 있는 XML 포맷으로 그것들을 찾기 위해서입니다. 이것들은 2개의 카테고리로 파생됩니다: ArchiCAD 내장(Sources/ACPM/ArchiCAD에 위치)과 Add-on 내장(Sources/APITools에 위치).

예제 라이브러리

예제 라이브러리도 제공해 줍니다. 일부 전형적인 use 케이스에 대한 샘플 라이브러리 파트와 매크로를 찾을 수 있습니다. 물론 이 매크로들을 작업할 때 이용할 수도 있습니다.

예제 라이브러리는 Basic Library 폴더에서 찾을 수 있습니다.

GDL 프로그래밍 표준

GDL의 20번 확장은 GDL 오브젝트와 오브젝트 라이브러리에 대한 요구를 증대시켰습니다. 결과적으로 많은 독립적인, 혹은 서드 파티 GDL 프로그래머들이 GDL 라이브러리를 개발하기 시작했습니다.

이 라이브러리들의 호환성과 Graphisoft 제품을 기대하는 사람들에게 품질을 보장하기 위해 프로페셔널 GDL 저자들을 위한 입증된 매크로, 예제, 그리고 가이드라인을 출판하였습니다. 이 프로그래밍 표준 문서는 팁, 트릭, 예제, 다른 것과 맞지 않는 일부 ArchiCAD 기능에 대한 설명도 포함하고 있습니다.

이 문서는 이 패키지 안에 포함되어 있습니다. 이것은 Basic Library documentation 폴더와 GDL 레퍼런스 가이드 (Miscellaneous/GDL Style Guide and Basic Technical Standards)에서 찾을 수 있습니다.

컴파일

패키지의 단순 컴파일

라이브러리와 XML간 컴파일이 가능하다고 하지만, 이 패키지에는 단순화된 시스템이 부착되어 있습니다. 이 경우, 일부 추가적인 라이브러리를 빌드하기 위한 필수 단계를 수집하였습니다. (예. ArhiCAD bulit-in)

이 PERL 기반 컴파일을 이용하려면 Windows 시스템의 경우 ActivePerl과 ActivePython이 필요합니다. (ActivePerl 홈페이지와 ActivePython 홈페이지) 이 기능은 Macintosh 시스템에 내장되어 있습니다.

Macintosh의 경우 터미널 윈도우에서, Windows의 경우 커맨드 프롬프트에서 단일 스크립트를 실행하여 전체 패키지를 컴파일할 수 있습니다.

예제 #1

작업한 것을 Sources/INT 폴더에 놓습니다. 이렇게 하면 당신이 ArchiCAD의 INT 버전(그리고 International built-in 리소스)을 기반으로 하는 International 내용을 만들었음을 확증할 수 있습니다. 이 경우 Windows, Macintosh 플랫폼 어디서나 파라미터 없이 MakeLibrary.pl을 호출하기만 하면 됩니다.

Windows - 'D:\LibraryDevelopment' 폴더 안에 이 패키지를 가지고 있다고 가정합니다.

perl D:\LibraryDevelopment\Sources\ArchiCADLibrary\Make\MakeLibrary.pl

Macintosh - '/Volumes/Development/LibraryDev' 폴더 안에 이 패키지를 가지고 있다고 가정합니다.

perl /Volumes/Development/LibraryDev/Sources/ArchiCADLibrary/Make/MakeLibrary.pl

예제 #2

예를 들어 5번째 체킹 단계에서 모든 built-in 라이브러리(ArchiCAD와 API 도구)를 컴파일한다고 합시다. 컴파일할 라이브러리가 International 라이브러리 기반임을 지정하고, 컴파일 후에 최종 단계를 하기 위해 도구에게 지시를 내립니다. (도구 문서를 보시기 바랍니다)

Windows - 'D:\LibraryDevelopment' 폴더에 이 패키지가 있다고 가정합니다.

perl D:\LibraryDevelopment\Sources\ArchiCADLibrary\Make\MakeLibrary.pl -b APITools -l INT -m finalizelibrary -c 5

Macintosh - '/Volumes/Development/LibraryDev' 폴더에 이 패키지가 있다고 가정합니다.

perl /Volumes/Development/LibraryDev/Sources/ArchiCADLibrary/Make/MakeLibrary.pl -b APITools -l INT -m finalizelibrary -c 5

모든 특수한 경우

다른 작업을 마치려면 LP_XMLConverter를 직접 사용하시기 바랍니다. 도구의 사용자 문서를 보시기 바랍니다.